home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / sio_v030.zip / BETA.TXT next >
Text File  |  1993-01-05  |  9KB  |  287 lines
  1. SIO.SYS vß0.30 01/05/93
  2.  
  3. SIO.SYS and VSIO.SYS are functional, but not exact, replacements for IBM's
  4. COM.SYS and VCOM.SYS.
  5.  
  6. This file should be read sequentially -- that is, subsequent version
  7. improvements/enhancements will be described as they are implemented.  Please
  8. read the ENTIRE file to determine current SIO/VSIO implementation.
  9.  
  10.  
  11. ----------------------------------------------------------------------------
  12.  
  13. Install SIO.SYS in OS/2 2.0's CONFIG.SYS like this (case is not significant):
  14.  
  15.  
  16. For COM1 & COM2 support only:
  17.  
  18. DEVICE=C:\SIO.SYS
  19.  
  20.  
  21. For COM1 through COM4 support:
  22.  
  23. DEVICE=C:\SIO.SYS (COM1,3F8,IRQ4) (COM2,2F8,IRQ3) (COM3,3E8,IRQ4) (COM4,2E8,IRQ3)
  24.  
  25.      other ports: (COMx,yyy,IRQz) where x=comm port number (1 to 8 supported)
  26.                                         yyy=address in hex, z=interrupt number
  27.  
  28.      note: the "COM" and "IRQ" prefixes are optional.  The number alone will
  29.            work just fine, ie: (1,3F8,4)
  30.  
  31.  
  32. If a 16550A Buffered UART is detected, it will be used.  OS/2's MODE BUFFER=
  33. parameter will have no effect on SIO.SYS' handling of the FIFO buffers (which
  34. are enabled at 8 bits receive, 16 bits transmit).
  35.  
  36. Be sure and REM out or remove the COM.SYS *and* VCOM.SYS lines.  This driver
  37. is ONLY for OS/2 comms at present and will not work with OS/2's VCOM.SYS.
  38. A companion VSIO.SYS DOS box virtual comms driver is coming up that will
  39. include support for DOS box FOSSIL comms operations as well.
  40.  
  41.  
  42. New in v0.00i:
  43.  
  44. Port(s) may be locked by adding a colon and the bps rate following the port
  45. number.  This will eliminate the need for OS/2's MODE command to set the
  46. port speed.  The 16550A UART will support port speeds of up to 115200 bps.
  47. Example:
  48.  
  49. DEVICE=C:\SIO.SYS (COM1:38400,3F8,IRQ4) (COM2:57600,2F8,IRQ3)
  50.  
  51.  
  52. New in 0.00j:
  53.  
  54. Binkley reports TO=On, BUFFER=Off, FIFO (Tx=1, Rx=1) -- should be TO=Off,
  55. BUFFER=ON, (Tx=8, Rx=16).  Fixed.
  56.  
  57.  
  58. New in 0.00k:
  59.  
  60. Binkley reports TO=Off, MODE reports TO=ON.  Fixed.
  61.  
  62.  
  63. New in 0.00l:
  64.  
  65. Minor code change.  Shouldn't affect anybody, but report if you see a change in
  66. operation.
  67.  
  68.  
  69. New in 0.00m:
  70.  
  71. XON/XOFF fixes, DOS box comms support via VSIO.SYS.  Install VSIO.SYS in
  72. CONFIG.SYS with no parameters, i.e:
  73.  
  74. DEVICE=C:\VSIO.SYS
  75.  
  76. After installing VSIO.SYS & SIO.SYS v0.00m, you will find there are 4 new
  77. OS/2 DOS session "DOS settings" available:
  78.  
  79. Uses_COM1
  80. Uses_COM2
  81. Uses COM3
  82. Uses_COM4
  83.  
  84. One or more of these can be set to ON by use of its "radio button" in the OS/2
  85. settings box, SESSION tab.  I experienced a "Trap 000d" after installing
  86. SIO.SYS and VSIO.SYS by attempting to open a DOS box prior to setting one of
  87. these, so be sure and modify your DOS settings after installation and before
  88. double-clicking on a DOS VDM icon.
  89.  
  90. These settings enable specific comm ports for DOS sessions in the same manner
  91. as VCOM.SYS' HW_COM option -- that is, comm port interrupts will be serviced
  92. by OS/2 directly, with no virtualization through SIO.SYS.  There is NO
  93. interprocess management, so multiple DOS comm sessions, or concurrent OS/2 and
  94. DOS comm activity are at this point somewhat problematical.  OS/2's MODE.COM
  95. is not able to access the port in the same session (it reports the port being
  96. in use by another process) -- this will be attended to soon.
  97.  
  98. True DOS box virtualization of the ports through SIO.SYS is next on the
  99. agenda, but throughput will ultimately be limited by OS/2's default interrupt
  100. handlers.  Native FOSSIL support will likely be added too, to eliminate the
  101. necessity of loading X00 v1.49a to support DOS box FOSSIL-based programs.
  102.  
  103. The bottom line is that OS/2 2.0 DOS box comms will still have performance
  104. problems.  To increase throughput in DOS sessions, the current OS/2 interrupt
  105. handlers will have to process more interrupts per second than they are
  106. presently capable of.  IBM points this out in the README.TXT that came with
  107. OS/2 2.0 GA -- however, NO such limitation applies to single or multiple
  108. native OS/2 comms sessions when SIO.SYS is used.
  109.  
  110. Essentially, this first version of VSIO.SYS provides isolation of DOS sessions
  111. and OS/2 sessions.  That is, it prevents DOS sessions from accessing a serial
  112. port that has not been flagged in the DOS session parameters (Uses_COMn).
  113.  
  114.  
  115. New in 0.00o:
  116.  
  117. VSIO.SYS code cleaned up - should solve some of the problems - NO performance
  118. enhancements.  MODE.COM can now access the port in the current session.
  119. SIO.SYS changed only to synchronize with some of the changes to VSIO.  From
  120. this version forward, SIO and VSIO versions should "match" - be sure that the
  121. file dates (not times) are identical.
  122.  
  123.  
  124. New in 0.00p:
  125.  
  126. Corrected a serious bug in VSIO.SYS that would/could cause a crash when a DOS
  127. session was started up.  Also, VSIO now checks that it matches the installed
  128. SIO -- if there is no match, VSIO will refuse to install.
  129.  
  130.  
  131. New in 0.00q:
  132.  
  133. Minor code changes that might fix the problems Ivan Schaffel is experiencing.
  134. Please report any other new features :-)
  135.  
  136.  
  137. New in v0.00r:
  138.  
  139. 4 new OS/2 DOS session "DOS Settings":
  140.  
  141. Simulate_COM1
  142. Simulate_COM2
  143. Simulate_COM3
  144. Simulate_COM4
  145.  
  146. These DOS settings will allow VSIO.SYS to emulate a 16550A UART to a DOS comm
  147. program in a VDM (whether there's a 16550A installed or not).  When these new
  148. settings are used, VSIO.SYS will route all serial I/O calls through SIO.SYS.
  149. The new settings must be used in conjunction with the "Uses_COMn" settings
  150. introduced in v0.00m.  Both "Uses_COMn" and "Simulate_COMn" must be "on" for
  151. "Simulate_COMn" on port n.
  152.  
  153.  
  154. New in v0.00t:
  155.  
  156. Major improvements in DOS box throughput.  Carrier detect (or lack of) problem
  157. fixed.  DTR is now dropped and 16550A FIFOs are disabled at shutdown or
  158. ctl-alt-del reboot.
  159.  
  160.  
  161. New in v0.00u:
  162.  
  163. Another DOS box problem fixed.
  164.  
  165.  
  166. New in v0.00v:
  167.  
  168. "Simulate_COMn" changed to "Virtualize_COMn".
  169.  
  170. At bootup, "Virtualize_COMn" defaults to "on" for all ports.  After replacing
  171. SIO/VSIO.SYS v0.00u with v0.00v, remove any DOS sessions from your startup
  172. routine before rebooting.
  173.  
  174. Attempting to open more than one DOS session accessing the same comm port
  175. could previously cause the system to crash -- this has been corrected.
  176.  
  177.  
  178. New in v0.00w:
  179.  
  180. More fixes to VSIO.SYS to eliminate possible Trap when DOS box is opened.
  181.  
  182.  
  183. New in 0.00x:
  184.  
  185. Mostly changes in VSIO dealing with DOS session startup and shutdown.  An
  186. error that could cause system crashes at DOS session shutdown was corrected.
  187.  
  188.  
  189. New in 0.00y:
  190.  
  191. Corrections in DOS startup that could cause VSIO to refuse to allow a DOS
  192. session to start.  Correction in 16550 virtualization that could cause some
  193. 16550-aware DOS programs not to work.  COM3/COM4 are not enabled unless spelled
  194. out in the SIO command line.  There is now only one DOS Setting
  195. "Virtualize_COM_Ports" which defaults to on.  This means that shelled DOS
  196. programs can now access the com ports.  Probably other fixes that slip memory.
  197.  
  198.  
  199. New in 0.00z:
  200.  
  201. 1 - New DOS settings, "Allow_Access_COMn".
  202.  
  203. 2 - Changes in 16550A virtualization
  204.  
  205. 3 - Code added to wake a sleeping DOS session
  206.  
  207. 4 - DOS sessions are (now) not allowed to change a locked baud rate
  208.  
  209. 5 - General clean up
  210.  
  211.  
  212. New in v0.00a:
  213.  
  214. 1 - COM ports used by DOS sessions are now freed up by most programs.  TSRs,
  215.     such as X00.EXE, will not release COM ports.
  216.  
  217. 2 - A problem was corrected that could cause crashes when a DOS session was
  218.     being closed.  This problem was most noticeable when multiple COM ports
  219.     were used by multiple DOS sessions.
  220.  
  221.  
  222. New in vß0.00b:
  223.  
  224. 1 - Corrected erroneous status errors (several of them).
  225.  
  226. 2 - Corrected flow control (RTS/CTS) problems.
  227.  
  228.  
  229. New in ß0.01a:
  230.  
  231. A problem with virtualized interrupts has been corrected.
  232.  
  233. VSIO no longer drops DTR between DOS programs.
  234.  
  235.  
  236. New in ß0.01b:
  237.  
  238. Additional problems have been corrected in the 16550 virtualization.
  239.  
  240.  
  241. New in ß0.10
  242.  
  243. Uploaded to CompuServe OS2USER, Library 3 as SIO010.ZIP
  244.  
  245.  
  246. New in ß0.11
  247.  
  248. An OS/2 bug caused crashes when SIO was used on a PS/2.  That problem has
  249. been corrected in this version.  Uploaded to CompuServe OS2USER, Library 3
  250. as SIO011.ZIP.
  251.  
  252.  
  253. New in ß0.15:
  254.  
  255. Multiple comm ports sharing the same IRQ on PS/2s and some ISA cards should
  256. now work.  Uploaded to CompuServe OS2USER, Library 3 as SIO015.ZIP.
  257.  
  258.  
  259. New in vß0.20:
  260.  
  261. New DOS Setting "Virtualize_16550A_For_COM".  If this setting is turned off,
  262. VSIO will create a virtual 16450.
  263.  
  264. A bug where DTR could be dropped in DOS sessions was corrected.
  265.  
  266.  
  267. New in vß0.25:
  268.  
  269. All of the DOS Settings are now prefixed with SIO_ in order to group them
  270. together.
  271.  
  272. Hopefully, the requirement for some systems to place SIO/VSIO last in the
  273. CONFIG.SYS has been eliminated.
  274.  
  275. This version (or later) must be used if you're running the OS/2 2.1 beta.
  276.  
  277.  
  278. Versions later than ß0.26:
  279.  
  280. See HISTORY.TXT file.
  281.  
  282.  
  283. Address comments, suggestions, bug reports, etc. to Ray Gwinn in the SIO_BETA
  284. conference available at 1:106/2000...
  285.                                                 - Bob Juge
  286.  
  287.